Summary

This branch rewrites the entire history of the repository to remove the large GIF assets, and updates the README to source demo videos from GitHub user-attachment URLs (uploaded via #10) instead of repo-hosted files.

Net effect:

• Large GIF blobs stripped from history → smaller repo
• No MP4s checked in either — videos live on github.com/user-attachments/assets/...
• README rendering: 4 inline video players (verified — user-attachments URLs are the only path that survives GitHub's markdown sanitizer)

Videos referenced (uploaded in #10):

• Sync demo
• Codegen demo
• Mock-server demo
• API AI-readiness demo

Repo size impact

Measured as total clone footprint on disk (du -sh after git clone), which is what new contributors actually pay:

The four GIFs accounted for nearly all of it:

After the rewrite, the largest blob in this branch is scripts/postman_client.py at 52 KiB — no binary assets remain.

⚠️ Caveat: other branches still carry the GIFs

A force-push of this branch to main alone will not shrink a default git clone of the upstream repo, because the GIF blobs are still reachable from 5 other branches. To get the full benefit, those branches need to be deleted (or rewritten) after the merge.

Maintainer integration steps

1. Force-push this branch to main

# From an up-to-date local clone of upstream:
git fetch https://github.com/jonico/postman-claude-code-plugin.git compress-gifs-to-mp4
git checkout main
git reset --hard FETCH_HEAD
git push --force-with-lease origin main

Or via the GitHub UI: temporarily lift branch protection on main, then run the above. Re-enable protection afterward.

2. Delete the GIF-carrying branches

Status of each branch (verified via `gh api .../compare/main...`):

To delete the three safe branches:

# Via git CLI (from an up-to-date local clone):
git push origin --delete feature/add-postman-context oauth-support task/add_postman_cli_skills

# Or via gh CLI:
gh api -X DELETE repos/Postman-Devrel/postman-claude-code-plugin/git/refs/heads/feature/add-postman-context
gh api -X DELETE repos/Postman-Devrel/postman-claude-code-plugin/git/refs/heads/oauth-support
gh api -X DELETE repos/Postman-Devrel/postman-claude-code-plugin/git/refs/heads/task/add_postman_cli_skills

3. Decide on the two remaining branches

`feature/private-network-search` — its original PR is merged but the branch has 5 commits ahead of main. Inspect with `git log main..feature/private-network-search` to see if anything is worth preserving. If not, delete the same way.

`jia.kim/revert-context` (PR #8 open) — either:

• Close PR Revert "Add Postman Context to skills" #8 and delete the branch, or
• Apply the same history rewrite to that branch (drop the GIFs from its history): `git filter-repo --invert-paths --path-glob 'assets/*.gif'` on a local checkout, then force-push.

4. (Optional) Trigger GitHub-side garbage collection

After branches are deleted, the GIF blobs become unreachable but may persist in GitHub's pack storage for a while. New clones will not include them, but to force an immediate repack, open a support request at https://support.github.com asking for a manual GC. Otherwise, GitHub eventually GCs unreachable objects on its own schedule.

Important — this is not a normal merge

Because the history was rewritten, commits on this branch do not share ancestry with `main`. A standard PR merge is not possible. To integrate, a maintainer must force-push this branch to `main` (per step 1 above) rather than using the GitHub merge button.

Everyone with a local clone will need to re-clone or hard-reset to the new `main` after the force-push.

Test plan

• Confirm all four videos render as inline players on the rendered README
• Step 1: force-push completed; verify `git clone --single-branch --branch main` is ~0.5 MB
• Step 2: delete the 3 safe branches; verify default `git clone` size drops
• Step 3: decide on `feature/private-network-search` and `jia.kim/revert-context`
• Coordinate with other contributors so they re-sync their local clones